MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

Jump to SDK endpoint

POST /openmlbb/user/auth/send-vc POST /openmlbb/user/auth/login POST /openmlbb/user/auth/logout GET /openmlbb/user/info GET /openmlbb/user/stats GET /openmlbb/user/privacy/settings POST /openmlbb/user/privacy/settings GET /openmlbb/user/season GET /openmlbb/user/matches GET /openmlbb/user/matches/{match_id} GET /openmlbb/user/heroes/frequent GET /openmlbb/user/matches/hero/{hero_identifier} GET /openmlbb/user/friends

GET User Match Details

/openmlbb/user/matches/{match_id}

Open Only This

API Path: /api/user/matches/{match_id}

Retrieve the authenticated player's detailed match information using a valid JWT. Supports query parameters for season filtering and localization. Requires an Authorization header with the JWT from login.

Headers:

  • Authorization: Bearer <jwt> (JWT obtained during login).

Path parameters:

  • match_id: Unique identifier of the match (from bid_s in /api/user/matches).

Query parameters:

  • sid: Season ID for filtering (must be a valid season ID from /api/user/season).
  • lang: Language code for localized content (default: en).

The response includes per-player match details:

  • f: Team flag (1 = Team A, 2 = Team B).
  • hid: Hero ID used in the match.
  • rid: Role ID (unique player identifier).
  • zid: Zone ID (server region).
  • k: Kills.
  • d: Deaths.
  • a: Assists.
  • tfr: Team Fight Rate (contribution ratio in team fights, tfr*100%).
  • o: Output (total damage dealt or hero damage).
  • op: Output Percentage (damage contribution relative to team).
  • s: Score (performance rating, s/100).
  • mvp: MVP flag (1 if MVP, 0 otherwise).
  • its: Item IDs equipped during the match.
  • its_e: Item entity metadata:
      • id: Item ID.
      • n: Item name.
      • ix: Item image URL.
      • i2x: Large item image URL.
  • eq: Equipment slot indicator.
  • ts: Timestamp of the match.
  • bd: Battle duration (seconds).
  • fk: First Kill flag (total kills in a team).
  • fw: First Win flag (1 for Win, 0 for Loss).
  • hid_e: Hero entity metadata:
      • id: Hero ID.
      • n: Hero name.
      • ix: Hero image URL.
      • i2x: Large hero image URL.
  • hlvl: Hero level reached in the match.
  • rname: Role name (localized string, e.g., 'ジャングラー').

This endpoint provides a full breakdown of each participant in the match, including:

      • Hero choice.
      • Performance stats (kills, deaths, assists, damage).
      • Items built with metadata.
      • Role assignment and team contribution.

It is useful for:

      • Reconstructing match history.
      • Analyzing team compositions.
      • Evaluating player performance in detail.

This endpoint requires JWT. Pass the token via the SDK call argument jwt="YOUR_JWT".

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.user.match_detail(1234567890, jwt="YOUR_JWT", sid=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
match_id path integer yes -
sid query integer yes -
lang query string no en